home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / mint / mint095s.zoo / doc / mint.doc
Text File  |  1992-08-02  |  32KB  |  645 lines
  1. MiNT is Not TOS: A Multitasking Operating System Extension for the Atari ST
  2.  
  3. Copyright 1990,1991,1992 Eric R. Smith. All rights reserved. See the file
  4. "copying" for conditions of redistribution.
  5.  
  6. WARNING: This program does some very low level things to your computer.
  7. MiNT works well on my machine, and I trust my data to it. But
  8. then, I make regular backups, so even if a horrible bug in MiNT that
  9. I haven't found yet trashes my hard drive, I won't lose much. You'll
  10. have to decide for yourself about trusting your data to MiNT. I would
  11. certainly recommend regular backups in any event.
  12.  
  13. MiNT COMES WITH ABSOLUTELY NO WARRANTY, NOR WILL I BE LIABLE FOR ANY
  14. DAMAGES INCURRED FROM THE USE OF IT. USE ENTIRELY AT YOUR OWN RISK!!!
  15.  
  16. Introduction
  17.  
  18. MiNT is an extension of (and eventually, I hope, a replacement for) TOS.
  19. It provides extra services such as multitasking and pipes. If you don't
  20. know what those terms mean, MiNT is probably not for you -- at this stage,
  21. MiNT is still very incomplete and should be regarded as "experimental".
  22.  
  23. MiNT will run a great number of ("most", I hope) TOS programs, including
  24. GEM. As the name says, though, MiNT is not TOS, so it can't be expected to
  25. run all TOS programs, or even all well-behaved TOS programs (although I hope
  26. that it will run "almost all" of the latter!). There are two classes of
  27. incompatibilities with TOS: bugs and features. Bugs are undoubtedly
  28. present; if you find any please report them to me. There are also some
  29. features of MiNT that may cause incompatibilites. Most of these are listed
  30. in the accompanying "features" file. 
  31.  
  32. MiNT tries to emulate TOS 1.4 very closely. If you have TOS 1.0 or 1.2,
  33. you may think you can use MiNT instead of buying TOS 1.4. This isn't really
  34. a very good idea, because MiNT calls TOS, and so having the newer version
  35. of TOS will really speed things up. Besides, the GEM that comes with TOS 1.4
  36. is a lot better than the old GEM.
  37.  
  38.  
  39. Using MiNT
  40.  
  41. MiNT can be started from an AUTO folder, by setting it as a BOOT program
  42. on the desktop (TOS 1.4 or higher only) or by running it. I prefer the AUTO
  43. folder way myself.
  44.  
  45. If you put it in an AUTO folder, it should be the last thing in the folder
  46. (since any later programs in the folder will run only after MiNT is finished,
  47. and MiNT should never finish). MiNT will try to run a program called
  48. "init.prg" in the current directory  (which is the root directory if MiNT
  49. was started from an AUTO folder). If this program isn't found, MiNT will
  50. boot up GEM. You can change the name of the initial program to run
  51. via the "mint.cnf" file (see below).
  52.  
  53. Once MiNT is running, the computer should behave just as it does under TOS,
  54. except that some new drives (U, Q, V, and X) will be available, background
  55. processes can be started, and programs can use the new features of MiNT.
  56.  
  57. MiNT can be asked to provide a trace of the currently executing programs.
  58. Hitting CTRL-ALT-F1 increases the debugging level; hitting CTRL-ALT-F2
  59. decreases it, and hitting CTRL-ALT-F3 changes where the debugging output
  60. goes; pressing it once changes it from the screen to the printer, pressing
  61. it again changes it to the RS232 port, pressing a third time sends debugging
  62. output to the MIDI port. Pressing CTRL-ALT-F4 resets output to the screen.
  63. This feature was designed to aid in debugging MiNT itself, but can also be
  64. useful in finding problems with user programs. Debugging level 0 (the normal)
  65. prints messages only when something goes seriously wrong inside of MiNT itself. 
  66. Debugging level 1 prints a message when any system call fails. Debugging level
  67. 2 provides a (sickeningly) exhaustive trace of what's going on in the system.
  68.  
  69. CTRL-ALT-F5 shows what memory is being used in the system
  70. CTRL-ALT-F6 prints a list of all processes in the system
  71. CTRL-ALT-DEL provides a (warm) boot, as in TOS >= 1.4, and
  72. CTRL-ALT-SHIFT-DEL provides a cold boot.
  73.  
  74. Some other keys are recognized by MiNT if the process is doing I/O in
  75. "cooked" mode:
  76. ^C (CTRL-C): interrupt running program with signal SIGINT. This (usually)
  77.     will kill the process, unless it has made arrangements to catch it.
  78.     Note that ^C takes effect immediately under MiNT, whereas under TOS
  79.     it only takes effect when the process reads or writes.
  80. ^\: send a QUIT signal to a process; usually the same end result as ^C, but
  81.     it is guaranteed to kill a TOS program (only MiNT specific programs
  82.     know how to catch it). Use with caution.
  83. ^Z: suspend the current process
  84.  
  85. These keys do *not* have any effect on processes operating in "raw" mode,
  86. such as editors. However, you can force these to work even on such programs
  87. by holding down the ALT key as well, i.e. CTRL-ALT-Z will always suspend
  88. the process. You should use caution when doing this, since some programs
  89. will function incorrectly and/or lose data if interrupted when they
  90. aren't expecting it.
  91.  
  92.  
  93. The MiNT Configuration File
  94.  
  95. If MiNT finds a file called "mint.cnf" in the directory that it was
  96. started from, it will read some configuration information from it. This
  97. file is an ordinary ASCII text file; it can be created with any editor
  98. that will produce plain ASCII files (if you're using a fancy word
  99. processor, make sure you save the file as "plain ASCII text" or
  100. "unformatted text" or whatever).
  101.  
  102. The commands in mint.cnf are placed one per line, and may be of the following
  103. forms:
  104.  
  105. INIT=d:\foo\bar.prg
  106.     This specifies the drive and full path name to the program you
  107.     want MiNT to run at boot up time. The default is try ".\init.prg",
  108.     if that file exists, otherwise to run the GEM desktop.
  109. HARDSCROLL=25
  110.     This specifies that hardware scrolling should be used for
  111.     the u:\dev\fasttext text accelerator. This dramatically speeds
  112.     up text operations, but may interfere with GEM and graphics
  113.     programs. Put this line *before* any use of u:\dev\fasttext.
  114. CON=u:\dev\fasttext
  115.     Specifies the use of MiNT's built in text accelerator instead
  116.     of the normal BIOS console. This speeds up text output quite
  117.     a bit (more than 300%) but may not be completely compatible;
  118.     in particular, the escape codes for setting foreground/background
  119.     character colors are not supported.
  120. PRN=d:\foo\bar
  121.     Specifies a file that should be used for all printer output.
  122.     (The default is u:\dev\centr, which is the device corresponding
  123.     to the centronics port.)
  124.  
  125. cd d:\foo
  126.     Change the current drive and directory. This isn't terribly
  127.     useful, unless your initial program (see above) expects to run
  128.     with some particular directory as the current one.
  129.  
  130. exec d:\bin\prog.prg arg1 arg2 ...
  131.     Execute a program, with some arguments. The full path name and
  132.     extension (.prg, .tos, .ttp, or whatever) of the program to
  133.     execute must be given.
  134.  
  135. ren d:\nm1 d:\nm2
  136.     Rename a file or directory. This is useful mainly on the pseudo-drive
  137.     v:, which refers to devices. For example, the RS232 port on the ST
  138.     is called "v:\modem1". Earlier versions of MiNT called this
  139.     "v:\rs232", so if your programs care about this you might want
  140.     to put "ren v:\modem1 v:\rs232" to maintain compatibility.
  141.     Similarly, if your software has been ported from Unix and expects
  142.     terminals to be called "tty*", then you might want to put
  143.     "ren v:\modem1 v:\tty1" instead.
  144.  
  145. setenv FOO BAR
  146.     Set the environment variable FOO to the value BAR. NOTE: If any
  147.     setenv commands are given in mint.cnf, an entirely new environment
  148.     is constructed; this means that any environment variables set by
  149.     a program in the AUTO folder will be ignored by programs run under
  150.     MiNT. This allows you to have two default environments, one for
  151.     running under MiNT set in mint.cnf, and one for normal TOS set
  152.     by an AUTO folder program.
  153.  
  154. sln d:\foo\bar u:\baz
  155.     Create a symbolic link called "u:\baz" for the file (or directory)
  156.     d:\foo\bar. Only drive u: supports symbolic links, so the second
  157.     name *must* be on drive u:; the first name can be anything.
  158.     A symbolic link is just an alias or nickname for a file; if the
  159.     sample line is included in your mint.cnf file, then references
  160.     to u:\baz are automatically translated by the kernel so that
  161.     they "really" refer to d:\foo\bar. If d:\foo\bar is act